/*
 * Copyright (c) 2024. hallele, Inc All rights reserved.
 */

package cn.hallele.mc.sdk.usercenter.api;

import cn.hallele.infrastructure.metadata.io.Page;
import cn.hallele.infrastructure.metadata.io.Response;
import cn.hallele.mc.sdk.usercenter.dto.UserDTO;
import cn.hallele.mc.sdk.usercenter.dto.UserQueryDTO;
import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.validation.Valid;
import org.springdoc.core.annotations.ParameterObject;
import org.springframework.cloud.openfeign.SpringQueryMap;
import org.springframework.web.bind.annotation.*;

/**
 * 用户管理接口
 *
 * @author anle5
 * @since 2024/10/5 13:32
 */
@Tag(name = "用户管理")
public interface UserApi {
    /**
     * 条件分页查询用户
     *
     * @param condition 查询条件
     * @return 用户
     */
    @GetMapping("userList")
    Response<Page<UserDTO>> listUser(@Valid @ParameterObject @SpringQueryMap UserQueryDTO condition);

    /**
     * 获取用户信息
     *
     * @param username 用户名
     * @return 用户信息
     */
    @GetMapping("user")
    Response<UserDTO> getUser(@RequestParam("username") String username);

    /**
     * 登录时候要获取的用户信息
     *
     * @param username 用户名
     * @return 用户信息
     */
    @GetMapping("loginUser")
    Response<UserDTO> getLoginUser(@RequestParam("username") String username);

    /**
     * 添加用户
     *
     * @param userDTO 用户信息
     * @return true：成功， false：失败
     */
    @PostMapping("user")
    Response<Boolean> addUser(@Valid @RequestBody UserDTO userDTO);

    /**
     * 修改用户
     *
     * @param userDTO 用户
     * @return 修改后的用户信息
     */
    @PutMapping("user")
    Response<UserDTO> updateUser(@Valid @RequestBody UserDTO userDTO);

    /**
     * 删除用户
     *
     * @param username 用户名
     * @return true：成功， false：失败
     */
    @DeleteMapping("user")
    Response<Boolean> deleteUser(@RequestParam("username") String username);

    /**
     * 修改密码
     *
     * @param username    用户名
     * @param oldPassword 旧密码，加密的
     * @param newPassword 新密码，加密的
     * @return true：成功， false：失败
     */
    @PutMapping("password")
    Response<Boolean> resetPassword(@RequestParam("username") String username,
                                    @RequestParam("oldPassword") String oldPassword,
                                    @RequestParam("newPassword") String newPassword);

    /**
     * 获取用户头像
     *
     * @param username 用户名
     * @return 用户头像
     */
    @GetMapping("avatar/{username}")
    Response<String> getAvatar(@PathVariable("username") String username);
}
